Cream of the Crop 1

home *** CD-ROM | disk | FTP | other *** search

/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / DOR421.ARJ / DOR.DOC next >

Wrap

Text File | 1992-03-15 | 20KB | 398 lines

0 ------------------------------------------------------------------------------ | DOR.EXE | | COPYRIGHT (C) 1990 Tim Ward | | | ------------------------------------------------------------------------------ DOR.EXE By Tim Ward, May 1990. Copyright (C) 1990 Tim Ward V4.2, March 1992 DOR.EXE is **NOT** Free software and is **NOT** Public Domain. DOR is provided AS IS ONLY. The author provides NO warranties, expressed or implied, and is NOT liable for any damage caused by the use or inability to use this program. DOR.EXE may be distributed freely, as long as the distribution package includes this documentation text file DOR.DOC. You may evaluate DOR for a 15-day period. If you still use DOR after this, you are expected to send a registration fee. DOR.EXE is NOT public domain software. If you use it, please send a registration of $15 [or more] to me Tim Ward, c/o The Enchanter's Lair 131 Naples St. Corpus Christi TX 78404-1828 1 Many people are often annoyed by the DIR command built-in to DOS. They say that it doesn't really tell them what they want to know, and users on color systems especially complain about that bland monochromatic text that DOS likes to throw at them. DOR was an effort to correct some of these minor deficiencies. Actually, DOR does far more than DIR, and can and does perform features found in DOS's CHKDSK command, in the SIZE command that some users may be familiar with, and also the LOCATE command. With DOR, you can list all files on your disk at once. If you wanted to make a file containing a list of all files currently on your disk, you would simply enter a command like "DOR \*.*/E-D > MYFILES.LOG" DOR can also calculate how much space files REALLY take up on your disk, as with the SIZE program. It of course, like DOS's DIR, gives you a count of how many files, and the amount of free space left on the drive, as well as the total capacity of the disk. You should note, that to retain similarity to DIR, the file count includes any subdirectories, UNLESS YOU INCLUDE THE "/E" PARAMETER. Unlike DIR and other utilities, DOR automatically inserts COMMAS into number to make them more readable *. It tries to find out the total memory of your system (under DOS, it will probably only find 640K maximum - an early silly oversight on the part of IBM (DOR does not search for extended or expanded RAM. If your system has more, it may not be reported )) and the amount free at the time (Naturally, it tries to underestimate if possible, and takes into account some of its own size.) To get help with the DOR syntax, simply enter "DOR /?" at the DOS prompt. "DOR /??" gives more help. "DOR /INFO" gives more information. DOR is probably of more use to you if you occasionally "loose" hidden and system files. And yes,DOR can search through hidden and system subdirectories. It can display files in two columns, one column plus either file attributes, plain, or real space used on disk, or four columns like BASICA's FILES. To terminate the listing of filenames, use either Ctrl-C or the Esc key. (DOR unfortunately still does not recognize the Ctrl-Break sequence.). NOTE: This might not always seem to work DOR 2.1 has a few changes over its previous incarnation, mainly in the way it treats hidden and system files, along with some code refinements to improve the way it handles subdirectory listings. Example - "DOR \D*" will list all directories starting with "D" that are one level down from the root directory. It also handles user key input better. Also improved is the way DOR recovers from errors or user breaks, and the way it handles subdirectories. (see note on following page) 2 ----------------------------------------------------------------------------- Directories and subdirectories. DIR can usually find the subdirectory that you are referring to. DOR tries its hardest to see which subdirectory you want to look into. Say that your hard disk had a directory called "QUUX" and that you now were in directory "FOO", and you issued the command "DOR QUUX" . DOR would first look to see if there is a file called "QUUX" in the directory FOO. It would then attempt to see if there was a subdirectory of FOO called QUUX. Failing all else, it would then proceed to see if there was a directory called FOO one level down from the root directory (i.e. "\FOO"). Sometimes DOR does show you a directory that you didn't want, this occurs only when you misspell the name of directory/file that you wanted to see, and THIS IS YOUR OWN FAULT ! Otherwise, it should show you what you want. Experiment! You might not guess offhand that the easiest way to list all files on the disk was "DOR \/e+s+h" You don't actually need to put spaces in separating the parameters. June 14, 1990. ---------------------------------------------------------->THaW<------------ Changes: I have done a bit of minor rework to ensure more graceful exits from certain error conditions (whereas before you might have been left in a different directory from that which you started in), and cleared up a bit of confusion about disks that have no volume label. Also have corrected a minor misfeature that was noticeable only to users with a mono system (such as myself !!) NOTE: Some people have asked about the /2 switch. In this listing mode, a "R" will be displayed next to the file size if it is READ-ONLY. Also, in this mode, files that have a "N" on their line DO NOT have the usual archive bit set. A "*" appearing on the file's line indicates that it is unusual, either in being READ-ONLY,HIDDEN,SYSTEM, or not having the ARC bit set. That's all that it means, really. Sorry if there was some confusion. June 21, 1990. ----------------------------------------------------------->THaW<--------------- 3 -------------------------------------------------------------------------------- Revision : 4.2.-1 It's been quite some time now, and I've still been using DOR all this time and just living with most of its problems, because I never got round to making any serious changes. Well, this isn't really the release I'd intended, that will be soon, though. Now: Easier to break out of listing with Ctrl-C or [Esc] keys. Subdirectory display handled better during subdirectory searches. New /ND switch gives Decimal values of charcaters in file names (easier to enter using the [Alt]-Numeric Keypad approach. Colors changed- all colors are bright on All video cards, except for ones which are by definition monochrome ie Herc, MDA. - This was changed the first time I used it on a VGA mono system. Sorry guys, I didn't realize how nasty it looked ! The "File size on target disk" feature works. To specify you want file sizes for a different drive use something like "DOR ]a:". Before, if the colon was entered there would be an error. * Format of various numbers loose the commas when the number gets too big. This is for those larger hard drives, which I hadn't considered last time. "R" and "N" indicators don't show up for directories on short listing "/B" option added. Date and time functions functional. Still working on the sorted directory listings. This may create problems, I might have to ban using the /E switch for large drives (otherwise we might have to try loading all the directory information for a 3GB drive if someone tried the wrong command.) I purposely have until now avoided the sorted directory listing . Why ?? Well, if I was going to do that, I might as well go ahead and make a whole file manager program, because all the directory info would have to be loaded into memory before sorting, which takes time and globs extra code (and expecially memory overhead.), depending on *how* you want the listing sorted. I'm not sure, either, if anyone could remember another N^X switches !! March 4, 1992. --------------------------------------------------------->THaW<--------- 4 Here is a sample of the output from DOR, of my E: drive (which is a logical drive assigned to Hard Disk #1) Volume label of drive E: is : Rumpus Q w! Directory of E:\ DOR42 C 33,620 3-15-92 1:48a ARC HELP COM 17,026 6-01-90 12:47p ARC DOR42 EXE 70,694 3-15-92 3:43a ARC DOR DOC 18,873 3-15-92 3:10a ARC DORX1 TXT 0 3-15-92 3:10a ARC DORX2 TXT 0 3-15-92 3:45a ARC 140,213 (159,744) Bytes 364,544 disk bytes total 640K total DOS memory 6 Files 212,992 disk bytes free 143,626 bytes free First, DOR gives the disk label, and the current directory, in this case, the root of E: Each file is listed as follows: File Name [+ extension] File Size (with comma seperators for files less than 10MB big) [for files larger than 10MB, if you want a comma-delimited size, you might have to just use the /Z switch] File Date (last two digits of year only displayed) File Time (Twelve-hour format, with "a" for A.M., "p" for P.M.) File attributes (in this case, only the ARC bits are set) The last two lines provide further information. The first number if the total space required for the selected files, as determined by adding their nominal filesizes (commas disappear when this number is over 10MB) The second number(in brackets) is the actual amount of space taken up on the disk by the files (which is usually different from the first.) (commas disappear when this number is over 100MB) The third number is the drive capacity in bytes The fourth number is the amount of RAM total reported by DOS (this will not include extended or expanded memory) On the second line, DOR totals the number of files [similar to DIR, directories are counted as files, unless subdirectory searching is specified for DOR's command line, in which case they are not. DOR generally knows the difference between files and directories] Next is the amount of space free on the drive. Lastly on this line, the amount of memory that DOS reports as being free [this is probably not the same amount given by CHKDSK, because I just estimated the worst case scenario for DOR's memory requirements, which may vary between machines, and command lines] 5 DOR [d:][\path\][filename.ext] [options] [ }t: ] (External) (C) 1990, 1992 Tim Ward Shows all files and subdirectories on the specified drive, or on the default drive if no drive is specified. Includes hidden and system files. Filename is color-coded according to file attributes. Displays total size of selected files on disk. Includes total and free drive space & memory. If t: is included, file sizes calculated for specified other drive. -A = Do not include files with arc bit set /A = list only files with arc -D = Do not include subdirectories /D = list only directories -L = Don't show individual file data /L = display file data only -R = Do not include read-only files /R = list only read-only files +S = Include system files /S = list only system files +H = Include hidden files /H = list only hidden files /N = Display hex dump of file name /E = Search in subdirectories /ND= Display decimal dump of file name /P = Pause after every page /Z = Display actual space used on disk by each file /2 = Display two columns of file listings. /4 = Ultrawide. Four columns, filenames only /INFO = More information /? = Displays this syntax help listing /?? = Help Page 2 (Page Two Help Screen...) /+ All files dated today or after /: Files with time after present time /- All files dated before today /; Files with time before present time /= All files dated today /=MM-DD-YYYY files dated on particular date /:HH:MM Files after certain time /-MM-DD-YYYY files before particular date /;HH:MM Files before certain time /+MM-DD-YYYY files on or after certain date Where HH=Hour (1-24), Where MM=Month,DD=Day,YYYY=Year MM=Minutes ** May be used to replace MM DD HH or MM. **** May be used to replace YYYY /B print files with full drive + Backslash path name. Examples Follow.......... DOR \*.TXT /E /P Displays all files with TXT extension, starting in the root directory, and searching all subdirectories ["/E"], Pausing every time the screen fills up ["/P"]. DOR /+01-01-1992 Finds all files in current directory that were date stamped on or after Jan 1st, 1992. DOR \/E /:17:00 /;20:00 Starts in the root directory ["\"] and searches all sub- directories ["/E"], finding files with time stamps After 5 P.M. ["/:17:00"], but with time stamps before 8 P.M. ["/;20:00"] 6 DOR *.ASM /; Finds all files in the current directory with the ASM extension that have time stamps before what the system clock is currently set to. DOR \/E /R /=02-**-1991 Starts in the root directory ["\"] and searches all sub- directories ["/E"] for files that are set to READ-ONLY ["/R"], that were dated for ANY DAY in February 1991 ["/=" means date equals to, "02" specifies February, "1991" is the year, and "**" matches for any day.] DOR \/E /=03-01-**** Starts in the root directory ["\"], and searches all sub- directories for files with a date stamp for April Fool's Day in any year. DOR \/E /+ /B >files.lst Ahah! Starting in the root directory, searching all sub- directories, with files stamped with the same date now set on the system clock (or later,) specifies the file by full drive:path\filename.extension, and writes this to the file files.lst. This gives a nice easy way to specify a list of files for backup purposes by a program such as, oh, um, PCCOPY. Do note that DOR if very flexible when specifing date and/or time ranges. DOR *.C /Z }B: Finds all files in the current directory with the extension "C", and shows you how much space each [and cumulatively] they take up on drive B: ---> Useful for when copying files to floppies. Disk information shown will also pertain to drive B: DOR *.WK1 }B: As above, but does not show amount of space required for individual files. DOR /L |SORT Provides a sorted listing. @ DOR /L |SORT /+14 sorted by size. @ DOR /L |SORT /+26 sorted by date. @ DOR /L |SORT /+34 sorted by time. @ DOR /L |SORT /+41 sorted by "unordinary attribute flag" @ DOR /L |SORT /+43 sorted by file attributes. @ If you use DOR /2, /4, or /B options, using |SORT /+n isn't probably a very good idea. 7 DOR \ /E /B /L |SORT >COMPLETE.LST Finds all files on the current disk, passes them as drive:path\filename.extension listing to the DOS Sort utility, and then writes them to the file COMPLETE.LST, which contains an sorted list of all the files on the disk. Note: Specifying "/L" will cause dor not to print drive & memory info, or directory names or disk name.... DOR then simply gives file data. HINT: If you are going to redirect output from DOR using > >> or | ,then it makes life much easier for you NOT to use the /Z option. [I mention this because it won't work !!] use something like this: DOR /L |SORT |MORE I have tried to idiot-proof this, however, it might not be enough. The Future: DOR 4.5 works with multiple drives, and can list files across multiple drives, with error-checking for drives that are not ready (such as floppies or removable hard disks), much in the way that a program called PCTODAY can. I intend to release 4.5 in just a few months, IFF some people actually respond and send registrations in. otherwise I won't bother with this any more (and you'll never get to use those sort switches!) I DO have other things to do with my time than endlessly revise old utlity progs. ----------------------------------------------------------------------------- DOR is just another example of the mindless creations brought about by Kawonk Experimental Software Projects. Later this year we hope to have a prototype of the adventure game RUNCIBAL QUEST ready for release Or, wait for the (possible but at the moment improbable) release of the popular arcade game, "Revenge of the Ovuloid Citruses." ------------------------------------------------------------------------------- Comments ? Complaints ?? Unusual personality disorders ?? Send a letter or postcard. [even if you are not going to pay the measly registration fee, tell me if you find any redeeming value in the program] Customized versions (such as if you want the +S and +H switches set to ON all the time)/ source code may be available for a fee.